10.1 查詢商家數位幣訂單（代收、代付）

#簡要描述： 此介面用於查詢商家的數位幣代收、代付等訂單，根據訂單號碼能夠查看其訂單詳情。

• 要求方式: POST
• 請求介面: https://网关域名/wallet-trade-merchant/payment/payment/by-third
• 請求媒體類型( JSON 資料格式 )Content-Type: application/json

查詢參數

參數名稱	類型	必填	參數意義	參數說明
orderId	string	否	平台訂單號碼	我方平台訂單號碼或商家本地訂單號碼2選1
localOrderId	string	否	商家本地訂單號碼	商家本地訂單號碼或我方平台訂單號碼2選1
key	string	是	商家key	apiKey
sign	string	是	簽章	詳情請見簽章演算法

請求json範例

{  
  "key": "9yUreYgTRtit39Dy",
  "orderId": 274224939517780,
  "sign": "07792d2cf97811d3f2e7bd98edb477e3"
}

傳回值

參數名稱	類型	參數意義	參數說明
code	int32	請求狀態	回傳代碼，0為業務成功，否則代表不同的錯誤
success	boolean	成功狀態	成功標識，與code=0一致，用於相容歷史
message	string	說明	錯誤訊息。如果有錯誤時，返回的錯誤訊息
data	json	傳回資料。	參數詳見下文說明

返回範例

{
   "code": 0,
   "success": true,
   "message": null,
   "data": {
        "merchantId": 302992856974,
        "merchantUserId": null,
        "orderId": "474882554749381",
        "localOrderId": "CONAN-TES1225668",
        "type": "PAYMENT",
        "status": "SUCCESS",
        "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
        "currency": "CNY",
        "amount": "75",
        "merchantCurrency": "CNY",
        "merchantPaidAmount": "75",
        "merchantActualAmount": "53.85",
        "userCurrency": "USDT",
        "userAmount": "11.19",
        "userReceivableAmount": "11.19",
        "userMinerFee": null,
        "rate": "6.70227804",
        "rateExpression": "1USDT≈6.7022CNY",
        "notifyTime": 1772461910628,
        "extra": null,
        "blockchain": {
             "network": "TRON",
             "txId":"403dd99b07cb2fd0a4a8ab3f99ef74c0
                     40700117a3429f393a74585ed3f23c09",
             "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
             "receiverAddress": "TYZSzcYySHGQ1Kb1oC3GdEM1NiK95BvnX7"
                     },
         "walletUserId": null,
         "orderFailReason": null,
         "orderCreateTime": 1772461861907
            }
}

data參數說明

參數名稱	類型	參數意義	參數說明
orderId	string	訂單編號
merchantId	int64	商家ID
merchantUserId	string	商家使用者ID	傳回下單參數 localUserId 的值，不傳則為 null
localOrderId	string	訂單編號
status	enum	訂單狀態	PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败
type	enum	訂單類型	PAYMENT:支付订单 | WITHDRAW:提款订单
bizType	enum	bizType類型說明如下
currency	string	訂單幣種
amount	string	訂單金額
merchantCurrency	string	商家收款幣種
merchantPaidAmount	number	商家應收或應付金額
userCurrency	string	用戶付款或提款幣種
userAmount	number	用戶支付或提款金額
merchantActualAmount	number	商家實收或實付金額
notifyTime	int64	通知時間戳記
orderCreateTime	int64	訂單建立時間戳記
blockchain	object	鏈交易資訊
└ network	string	主網
└ txid	string	交易ID
└senderAddress	string	傳送位址
└receiverAddress	string	收款地址
userMinerFee	string	礦工費
userReceivableAmount	string	用戶應收、應付金額
rate	string	匯率
rateExpression	string	匯率表達式
orderFailReason	string	訂單失敗原因
walletUserId	string	皮夾內部用戶ID
extra	json	自訂匯率資訊	商家呼叫自訂匯率介面會傳回此資訊

bizType類型說明：

1、PAYMENT_WALLET_SCAN VAPY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至VAPY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付